CallGetErrDescProc

Inside Macintosh: OpenDoc Class Reference /: Part 1 - Classes and Methods / ODSemanticInterface

CallGetErrDescProc
The CallGetErrDescProc method gets a reference to the part's global error descriptor object.
void CallGetErrDescProc (in ODPart thePart, 
                         out ODDesc errDesc);
thePart
A reference to the part associated with this semantic interface object.
errDesc
A reference to the part's global error descriptor object.

DISCUSSION
OpenDoc calls this method before an attempt is made to resolve an object specifier and again during object resolution if an exception arises. The first call of this method clears out the errDesc parameter and sets its descriptor type to typeNull. If an exception occurs during object resolution, the second call to this method fills in the errDesc parameter with the descriptor record that caused the exception.
Your override of this method should define the descriptor record as a global variable and use the same descriptor for all your exception handling. When your part receives an exception during object resolution, it can use your global descriptor record to get information about the exception.

EXCEPTIONS
The Apple Event Manager may throw an exception if this semantic interface does not support this functionality.
This method may throw platform-specific exceptions.

SEE ALSO
The ODDesc class (page 104).